Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New Utils\MessageHelper class #249

Merged
merged 1 commit into from
May 12, 2021
Merged

Conversation

jrfnl
Copy link
Member

@jrfnl jrfnl commented May 12, 2021

This class initially introduces five new utility methods for working with error/warning messages.

The class currently contains the following methods:

  • addMessage() - simple method to add either an error or a warning to PHPCS based on an $isError parameter. Returns boolean (same as PHPCS natively).
    Supports all optional parameters supported by PHPCS.
  • addFixableMessage() - simple method to add either a fixable error or a fixable warning to PHPCS based on an $isError parameter. Returns boolean (same as PHPCS natively).
    Supports all optional parameters supported by PHPCS.
  • stringToErrorcode() - to convert an arbitrary text string to an alphanumeric string with underscores. Returns the adjusted text string.
    This method is intended to pre-empt issues in XML and PHP when arbitrary text strings are used as (part of) an error code.
  • hasNewLineSupport() - to check whether PHPCS can properly handle new lines in violation messages.
    Prior to PHPCS 3.3.1, new line support in error messages was buggy.
    Ref: Report Full: various message formatting fixes squizlabs/PHP_CodeSniffer#2093
  • showEscapeChars() - to make the whitespace escape codes used in an arbitrary text string visible. Returns string.

Includes dedicated unit tests for each method.

This class initially introduces five new utility methods for working with error/warning messages.

The class currently contains the following methods:
* `addMessage()` - simple method to add either an error or a warning to PHPCS based on an `$isError` parameter. Returns boolean (same as PHPCS natively).
    Supports all optional parameters supported by PHPCS.
* `addFixableMessage()` - simple method to add either a fixable error or a fixable warning to PHPCS based on an `$isError` parameter.  Returns boolean (same as PHPCS natively).
    Supports all optional parameters supported by PHPCS.
* `stringToErrorcode()` - to convert an arbitrary text string to an alphanumeric string with underscores. Returns the adjusted text string.
    This method is intended to pre-empt issues in XML and PHP when arbitrary text strings are used as (part of) an error code.
* `hasNewLineSupport()` - to check whether PHPCS can properly handle new lines in violation messages.
    Prior to PHPCS 3.3.1, new line support in error messages was buggy.
    Ref: squizlabs/PHP_CodeSniffer#2093
* `showEscapeChars()` - to make the whitespace escape codes used in an arbitrary text string visible. Returns string.

Includes dedicated unit tests for each method.
@jrfnl jrfnl force-pushed the feature/new-message-helper-class branch from 157d2bb to 581c21a Compare May 12, 2021 19:58
@jrfnl jrfnl merged commit cb5f20c into develop May 12, 2021
@jrfnl jrfnl deleted the feature/new-message-helper-class branch May 12, 2021 21:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

1 participant